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How to Git Better 


4>g 


Using Git Workflows 

(with some help from Atlasssian) 



Why should we Git Better? 


* Software Craftsmanship 

* You are as proficient as you are 
familiar with your tools 

* You are more likely to cut 
yourself with a dull knife than a 
sharp one 



Fair Warning: Fancy Git Talk aHEAD 



♦ Requires decent understanding 
of Git branches 

* Lots of Pictures 


* Available "Git up to Speed” 
Brown Bag (before 22 June) 



NEWSFLASH! Git is not Version Control! 


* You: Umm... so what is it then? 

♦ Git is a set of tools that provides a workflow for your 
version control. 


* You: Umm... and that means what exactly? 

❖ Use Git to customize your team’s way of using version 
control in your daily development. 



MIND = BLOWN 




MIND = BLOWN 



Popular Workflows for Git 

* This is well treaded territory. . . in industry 

❖ Documented in Confluence on DEVLAN 

1 . Centralized 

2. Feature Branch 

3. Git Flow 

4. Forking 


Popular Workflows for Git 

* This is well treaded territory. . . in industry 

❖ Documented in Confluence on DEVLAN 

1 . Centralized 

2. Feature Branch 

3. Git Flow ( ~ p ) 


4. Fork i ng (see Confluence) 


Centralized (and why it’s bad) 
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Centralized (and why it’s bad) 



Typical Git 3-Way Merge 




Typical Git 3-Way Merge 




Centralized (and why it’s bad) 


* Everyone for themselves! 

* Errors compounded 

* Knowledge partitioning 

* Clear history... 

* Lack of project organization 

* No efforts to improve quality built 
into workflow 
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Solution: Modify Workflow 


Solution: Modify Workflow 


* Keep master clean! 

* No direct commits 

* No broken builds 

* No partial features 

* Merges only 


ONE DOES NOT 
SIME1Y * 



MERGE INTO MASTER.,,. 

nidii^y ei ici dior. 
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Solution: Modify Workflow 


* Keep master clean! 

* No direct commits 

* No broken builds 

* No partial features 

* Merges only 

* Code Review of changes by team 
before merge 

* Clear history 

* Clear improvements to quality 


•Ni DOES NOT 
SIME1Y * 



MERGE INTO MUSTER,,. 

dlOl. 



Feature Branching - A Branch Per Feature 



Feature Branching - 






A Branch Per Feature 


Feature Branching 



Source 

Repo 







Feature - Source Branch 


Pull Requests 


Destination 

Repo 
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Master - Destination Branch 



Feature Branching 



Discussion 


Pull Requests 



Follow-Up Commits 


Feature Branching 
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Feature Branching 



Pull Requests 



Feature Branching 


Pull Requests give us : 

* A stable master branch protected from chaos 

* Digestible pieces of Code Review 

* Knowledge sharing / Collective code ownership 

* Clear history of changes 

* Clear improvements made 


ONE DOES NOT 


SIMPLY 
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MERGE INTO MASTER 
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a dtor 


But how about long term projects? 



Git Flow, or How I Became OCD about DVCS 


Master 


Hotfix 


Release 


Develop 


Feature 


Feature 
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Git Flow: Historical Branches 


Master 


Develop 






♦ master contains stable delivered versions only 

* develop is for stable incorporation of new features 




Git Flow: Historical Branches 



♦ master contains stable delivered versions only 

* develop is for stable incorporation of new features 


Git Flow: Feature Branches 



Develop 


♦ New features incorporated (by feature branching!) into develop 




Git Flow: Feature Branches 



♦ Branch from develop 


♦ Pull Request to merge into develop 
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♦ Branch from develop 


♦ Pull Request to merge into develop 



Git Flow: Release Branches 
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* No new features — only fixes 
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Git Flow: Release Branches 



Master 



Develop 


Release candidates executed in separate release branch 
No new features — only fixes 





Git Flow: Hotfix Branches 




♦ Branch for applying hotfixes (perfect for Discrepancy Reports) 


♦ Merge into master and develop 



Git Flow: Hotfix Branches 




♦ Branch for applying hotfixes (perfect for Discrepancy Reports) 


♦ Merge into master and develop 



How Atlasssian Helps 


* Track all issues in Jira 

* Create feature branch 
from each Jira issue 


Create branch for RB-62 


Repository RickyBobby/ Ricky Bobby_CSharp ▼ 

Branch type Feature ▼ 

Leam about branch types 

Branch from U develop ▼ 

Branch name feature/ RB-62-cal_shell-changes-for-list-uplOc 





V develop 

V feature/RB- 62 -cal_shell-changes-for-list-up 


Create branch 


Cancel 



How Atlasssian Helps 


Merge Pull Request 


X 


Track all issues in Jira 


■ Merge pull request #19 in iOS/nscore from bugfix/IOS-137-debug- 
init-dispatch-once to master 


Create feature branch 
from each Jira issue 

Merge feature branch in 
Stash using Pull 
Requests 


Add to the commit message... 



V bugf ix/IOS-137-debug-init-dispatch-once 

V master 


Delete source branch after merging 


Merge 


Cancel 



Questions? 


Questions? 



GO FORTH AND ROCK 


